package com.yuzhi.system.service;



import com.yuzhi.system.domain.Area;
import com.yuzhi.system.domain.AreaShort;

import java.util.List;
import java.util.Map;

/**
 * <p>
 * 服务类
 * </p>
 *
 * @author njhh
 * @since 2020-08-24
 */
public interface IAreaService {

    /**
     * 查询全国地区树
     *
     * @return
     */
    Map<String, Area> getAllAreasMap();

    List<AreaShort> getAllProvinces();

    /**
     * 根据行政区编码,获取行政区信息(包含子级数据)
     *
     * @param areaCode
     * @return com.njhh.common.vm.support.area.Area
     * @author: Mario
     **/
    Area getByCode(String areaCode);

    /**
     * 根据行政区编码List集合,获取行政区信息(包含子级数据)
     *
     * @param areaCodes
     * @return java.util.List<com.njhh.common.vm.support.area.Area>
     * @author: Mario
     **/
    List<Area> getByCodes(List<String> areaCodes);

    /**
     * 根据行政区编码可变长度参数,获取行政区信息(包含子级数据)
     *
     * @param areaCodes
     * @return java.util.List<com.njhh.common.vm.support.area.Area>
     * @author: Mario
     **/
    List<Area> getByCodes(String... areaCodes);

    /**
     * 根据行政区名称与等级获取行政区信息(包含子级数据)
     *
     * @param areaName
     * @param level    0 省 1市 2区/县
     * @return
     */
    Area getByName(String areaName, Integer level);

    /**
     * 根据行政区编码List集合,获取行政区信息(包含子级数据)
     *
     * @param areaCodes
     * @return java.util.Map<java.lang.String, com.njhh.common.vm.support.area.Area>
     * @author: Mario
     **/
    Map<String, Area> getAsMap(List<String> areaCodes);

    /**
     * 获取所有的省份
     *
     * @return java.util.List<com.njhh.common.vm.support.area.Area>
     * @author: Mario
     **/
    List<Area> getProvinces();

    /**
     * 获取所有的城市
     *
     * @return java.util.List<com.njhh.common.vm.support.area.Area>
     * @author: Mario
     **/
    List<Area> getCities();

    /**
     * 根据行政区编码,获取本身与所有子级行政区编码
     *
     * @param areaCode
     * @return java.util.List<java.lang.String>
     * @author: Mario
     **/
    List<String> getSelfAndSonCodes(String areaCode);

    /**
     * 根据行政区名称,行政区编码
     *
     * @param extName(例如：玄武区)
     * @return
     */
    String getCodeByExtName(String extName);

    /**
     * 根据行政区编码获取完整所属地区信息(例如：320102 -> 江苏省南京市玄武区)
     *
     * @param areaCode
     * @return java.lang.String
     * @author: Mario
     **/
    String getCompleteInfoByCodeData(String areaCode);

    /**
     * 只获取省份
     *
     * @return java.util.List<com.njhh.biz.basic.area.entity.Area>
     * @date: 2023/5/24
     * @author: Mario
     */
    List<Area> getOnlyProvinces();


    /**
     * 根据省获取市区
     *
     * @param provinceCode
     * @return com.njhh.biz.basic.area.entity.Area
     * @date: 2023/5/25
     * @author: Mario
     */
    List<Area> getCityAndDistrictByProvince(String provinceCode);
}
